package com.bookstore.back.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.bookstore.back.entity.Bestseller;
import com.bookstore.back.entity.Book;

import java.util.List;
import java.util.Map;

/**
 * 畅销榜单服务接口
 * 
 * @author 程序猿_Ti
 * @since 2025-07-23
 */
public interface BestsellerService extends IService<Bestseller> {

    /**
     * 分页查询畅销榜单列表
     * 
     * @param params 查询参数
     * @return 分页结果
     */
    IPage<Bestseller> getBestsellerList(Map<String, Object> params);

    /**
     * 创建畅销榜单记录
     * 
     * @param bestseller 畅销榜单信息
     * @return 是否成功
     */
    boolean createBestseller(Bestseller bestseller);

    /**
     * 更新畅销榜单信息
     * 
     * @param bestsellerId 榜单ID
     * @param bestseller 榜单信息
     * @return 是否成功
     */
    boolean updateBestseller(Integer bestsellerId, Bestseller bestseller);

    /**
     * 删除畅销榜单记录
     * 
     * @param bestsellerId 榜单ID
     * @return 是否成功
     */
    boolean deleteBestseller(Integer bestsellerId);

    /**
     * 批量更新排名
     * 
     * @param rankUpdates 排名更新列表
     * @return 是否成功
     */
    boolean updateBestsellerRanks(List<Map<String, Object>> rankUpdates);

    /**
     * 获取可添加到畅销榜的图书列表
     * 
     * @param params 查询参数
     * @return 图书列表
     */
    List<Book> getAvailableBooks(Map<String, Object> params);

}
